home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 036a / ezcode28.zip / EZCODE.MAN < prev    next >
Text File  |  1993-04-04  |  21KB  |  537 lines
  1.  
  2.  
  3.  
  4.                 
  5.                 EZ CO*DE RELEASE 2.8
  6.  
  7.          A COMPRESSION/DECOMPRESSION UTILITY SHELL
  8.  
  9.            COPYRIGHT 1993  CHARLES HILL  USEFULL CONCEPTS
  10.                 ALL RIGHTS RESERVED
  11.  
  12.                1303 B CARLISLE DRIVE
  13.              SAN MATEO, CA. 94402-1917
  14.                     USA
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                   CONTENTS
  21.  
  22.  
  23.               GETTING INTRODUCED ............ 1
  24.  
  25.  
  26.               GETTING INSTALLED ............. 1
  27.  
  28.  
  29.               MOUSE TUTORIAL ................ 2
  30.  
  31.  
  32.               KEYBOARD TUTORIAL ............. 3
  33.  
  34.  
  35.               GETTING THE PICTURE ........... 4
  36.  
  37.  
  38.               GETTING LEGAL ................. 7
  39.  
  40.  
  41.               GETTING REGISTERED ............ 8
  42.  
  43.  
  44.               GETTING HISTORICAL ...........  9
  45.  
  46.                                       PAGE 1
  47.  
  48.  
  49.                   GETTING INTRODUCED
  50.  
  51.   * ABOUT THIS MANUAL
  52.  
  53.   Since EZ CO*DE is meant to make your life simpler, we'll try to keep this
  54.   manual simple too; telling you just what you need to know. After you have
  55.   "tinkered" around with it for a while, the auto help lines in the program
  56.   will be all you'll need. BE SURE TO READ THE WARNINGS ON MOVING FILES.
  57.  
  58.   * WHAT IS EZ CO*DE?
  59.  
  60.   EZ CO*DE is a shareware computer shell program which, when used with a
  61.   compatible archiving utility, provides the user with a menu driven multiple
  62.   choice method of enjoying archiver benefits. EZ CO*DE supports :
  63.   .ZIP, .LZH, .PAK, .ARC, .SDN, .ARJ and .ZOO files along with their self
  64.   extraction counterparts. EZ CO*DE allows simple file compression and
  65.   decompression or more sophisticated tasks if your situation calls for them.
  66.  
  67.   * WHAT IS NEEDED TO RUN EZ CO*DE ?
  68.  
  69.   You must have one of the following archiving programs. To use the other
  70.   features listed in the table you must attain the corresponding programs.
  71.   These programs must be installed in a directory in your path.
  72.  
  73.   EZ CO*DE SUPPORTS ALL OF THESE METHODS AND THEIR PREVIOUS VERSIONS.
  74.  
  75.   ┌─────────────────────┬──────────────┬────────────┐
  76.   │ Archive        │ Needed For   │ Needed For │
  77.   │ Program        │ Self Extract │ Recursion  │
  78.   ├─────────────────────┼──────────────┼────────────┤
  79.   │ PKZIP & PKUNZIP 2.0 │ ZIP2EXE 1.1  │ None        │
  80.   │ LHA 2.13        │ None           │ None        │
  81.   │ PAK 2.51        │ None           │ None        │
  82.   │ ARJ 2.30        │ None           │ None        │
  83.   │ ZOO 2.1        │ SEZ 2.3      │ STUFF 1.0  │
  84.   └─────────────────────┴──────────────┴────────────┘
  85.  
  86.   * None means the option is included in the archive program.
  87.  
  88.   EZ CO*DE will run on any IBM compatible XT/AT computer using DOS 2.1 and
  89.   up, and supports any Microsoft compatible mouse. It uses about 185K of
  90.   working memory, plus memory for the archiving utility. When directories or
  91.   archives contain more than 400 files, more memory will be used. A hard disk
  92.   is recommended. EZ CO*DE supports CGA, EGA and VGA display adapters.
  93.  
  94.                   GETTING INSTALLED
  95.  
  96.   Simply put a copy of EZCODE.EXE in a directory in your path. You may change
  97.   the name to suit your needs (ie EC.EXE). To run type <EZCODE>. Make sure
  98.   the archive programs you wish to use are located in your path.
  99.  
  100.   NOTE : EZCODE makes and removes a directory called "$e" in the root
  101.   directory of the startup drive to view files from archives. If EZCODE finds
  102.   this directory to exist, it will yield a warning at startup.
  103.  
  104.                                       PAGE 2
  105.  
  106.  
  107.                    MOUSE TUTORIAL
  108.  
  109.   - OVERVIEW -
  110.   With the mouse select "Extract" from the main menu. A pop-up menu appears
  111.   listing the choices for extraction. The top menu item "Check Overwrite ..."
  112.   is highlighted. The help line at the bottom explains what this item will do
  113.   when executed. Click on the remaining items noting the help line.
  114.  
  115.   Now, select "Add" from the main menu. Examine each item as you did before.
  116.   Continue until you have completed all the items on the main menu. When you
  117.   are finished move the mouse outside the popup menu and click to cancel.
  118.  
  119.   - CREATING AN ARCHIVE -
  120.   Select " Archive ". Next select "Input ...". The input box shows the path of
  121.   the current directory by default. For this example we'll use the default.
  122.   Type the name "test.zip". If you are using an archiver other than PKZIP, use
  123.   the appropriate extension. Press <Enter>. Notice the right window now
  124.   displays the name "..\test.zip" and reports that it is new. Note that
  125.   test.zip does not actually exist until files are added to it.
  126.  
  127.   - TAGGING FILES FOR COMPRESSION -
  128.   If the Directory window does not contain any files, select " Directory "
  129.   to choose a directory which does. Now, tag some arbitrary files in the
  130.   Directory window. To tag a file, click on it to hightlight it and click it
  131.   again to tag it. A '√' appears in the TAG column confirming selection.
  132.  
  133.   - COMPRESSING THE TAGGED FILES -
  134.   Select "Add" from the main menu. Select "Overwrite ...". Select "Tagged".
  135.   Your screen reports that compression is taking place. When you return, note
  136.   that test.zip contains the files you tagged.
  137.  
  138.   - SELECTING AN EXISTING ARCHIVE -
  139.   For this section exit the program by clicking <F10=Exit>. Run EZCODE again.
  140.   Select " Archive ". Use the selection window to get to the directory
  141.   containing test.zip and then select test.zip. Note that test.zip is now
  142.   displayed in the right window.
  143.  
  144.   - DELETING test.zip -
  145.   Activate the Directory window. Highlight test.zip. Select "File" from the
  146.   main menu. Select "Delete". Select "Highlighted". On return, note that
  147.   test.zip still appears in the right window and reports it is new. As noted
  148.   above, test.zip does not actually exist until files are added to it. You'll
  149.   note that the Directory window no longer contains the file test.zip.
  150.  
  151.   This concludes the tutorial. You now have a good idea how to operate
  152.   EZ CO*DE. The section "GETTING THE PICTURE" explains all the options
  153.   available to you. If you have a problem, please notify USEFULL CONCEPTS.
  154.  
  155.                                       PAGE 3
  156.  
  157.  
  158.                   KEYBOARD TUTORIAL
  159.  
  160.   - OVERVIEW -
  161.   Press <Alt>. The pop-up menu for the main menu item "Extract" appears
  162.   listing the choices for extraction. The top menu item "Check Overwrite ..."
  163.   is highlighted. The help line at the bottom explains what this item will do
  164.   when executed. Scroll through the remaining items noting the help line.
  165.  
  166.   Move right to "Add". Examine each item as you did before. Continue until
  167.   you have completed all the items on the main menu. When you are finished
  168.   press <ESC> to cancel.
  169.  
  170.   - CREATING AN ARCHIVE -
  171.   Activate the Archive window using the left-right arrow keys. Press "Enter"
  172.   to bring up the archive file selection window. Next select "Input ...". The
  173.   input box shows the path of the current directory by default. For this
  174.   example we'll use the default. Type the name "test.zip". If you are using
  175.   an archiver other than PKZIP, use the appropriate extension. Press <Enter>.
  176.   The right window now displays the name test.zip and reports that it is new.
  177.   Note that test.zip does not actually exist until files are added to it.
  178.  
  179.   - TAGGING FILES FOR COMPRESSION -
  180.   If the Directory window does not contain any files, activate it and press
  181.   "Enter" to bring up the directory selection window. Select a directory which
  182.   does. Now tag some arbitrary files for compression. To tag a file, highlight
  183.   it and press <Enter>. A '√' appears in the TAG column confirming selection.
  184.  
  185.   - COMPRESSING THE TAGGED FILES -
  186.   Select "Add" from the main menu. Select "Overwrite ...". Select "Tagged".
  187.   Your screen reports that compression is taking place. When you return, note
  188.   that test.zip contains the files you tagged.
  189.  
  190.   - SELECTING AN EXISTING ARCHIVE -
  191.   For this section exit the program by pressing F10. Run EZCODE again.
  192.   Activate the Archive window and press "Enter". Use the selection window to
  193.   get to the directory containing test.zip and then select test.zip. Note
  194.   that test.zip is now displayed in the Archive window.
  195.  
  196.   - DELETING test.zip -
  197.   Activate the Directory window. Highlight test.zip. Select "File" from the
  198.   main menu. Select "Delete". Select "Highlighted". On return, note that
  199.   test.zip still appears in the right window and reports it is new. As noted
  200.   above, test.zip does not actually exist until files are added to it. You'll
  201.   note that the Directory window no longer contains the file test.zip.
  202.  
  203.   This concludes the tutorial. You now have a good idea how to operate
  204.   EZ CO*DE. The section "GETTING THE PICTURE" explains all the options
  205.   available to you. If you have a problem, please notify USEFULL CONCEPTS.
  206.  
  207.                                       PAGE 4
  208.  
  209.  
  210.                  GETTING THE PICTURE
  211.  
  212.   IMPORTANT: The copyrighted documentation that came with your archiving
  213.   utility goes into great detail on the functions available with that
  214.   program. EZ CO*DE supports most of the functions for these programs. Listed
  215.   here are the functions supported by EZ CO*DE.
  216.  
  217.   NOTE : For the Extract, Add, Move, Delete, Remark and File menus, you will
  218.   use "Highlighted", "Tagged" or "Input ..."  to define the files to operate
  219.   on. With Input you can define files using the DOS wildcard characters.
  220.  
  221.   * EXTRACT
  222.  
  223.   The function of "Extract" is to decompress files from the archive in the
  224.   archive window and put them in a directory of your choice. The options are :
  225.  
  226.   Check Overwrite ... :
  227.   Checks your chosen directory for files with the same name. If any are
  228.   found you will be asked if you want to overwrite them.
  229.  
  230.   Overwrite ... :
  231.   Extracts the chosen files and will overwrite any existing files with the
  232.   same name.
  233.  
  234.   Update ... :
  235.   Extracts the chosen files if they are new or if they have the same name
  236.   and are more recent than the files in the chosen directory.
  237.  
  238.   Freshen ... :
  239.   Extracts the chosen files if they are same named and more recent than the
  240.   files in the chosen directory.
  241.  
  242.   * ADD
  243.  
  244.   The function of "Add" is to compress files and add them to the archive in
  245.   the archive window. The options are :
  246.  
  247.   Overwrite ... :
  248.   Compresses chosen files and will overwrite same named files.
  249.  
  250.   Update ... :
  251.   Compresses chosen files if they are new or if they are same named and more
  252.   recent than the files in the archive.
  253.  
  254.   Freshen ... :
  255.   Compresses chosen files only if they are same named and more recent than
  256.   the files in the archive.
  257.  
  258.   * MOVE
  259.  
  260.   Same as "Add" except it deletes the selected files after they are added.
  261.  
  262.   WARNING : The files selected will be deleted regardless of whether or not
  263.   they meet the "Update" or "Freshen" criteria.
  264.  
  265.                                       PAGE 5
  266.  
  267.  
  268.   * DELETE
  269.  
  270.   The function of "Delete" is to delete selected files from the archive in
  271.   the archive window. NOTE : To delete directory files, use the "File" menu.
  272.  
  273.   * REMARK
  274.  
  275.   This function will allows you to enter descriptive comments to your
  276.   archives or to the individual files within.
  277.  
  278.   * LIST
  279.  
  280.   This function contains the options listed below.
  281.  
  282.   Archive :
  283.   This selection will allow you to view the contents of the archive in the
  284.   archive window in the archivers format.
  285.  
  286.   Archive w/path :
  287.   Same as View CPF, except it will include path information.
  288.  
  289.   Archive w/tech :
  290.   Same as View CPF, except it will include detailed techinical information.
  291.  
  292.   * MISC
  293.  
  294.   This function contains the options listed below.
  295.  
  296.   Create SFX :
  297.   The SFX function creates a self-extract file (ie test.exe) from an
  298.   archive (ie test.zip).
  299.  
  300.   Test CPF :
  301.   The test function will test the integrity of an archive and report any
  302.   errors found.
  303.  
  304.   * SORT
  305.  
  306.   This function sorts the files in the higlighted window and sets the sort
  307.   filter, so that future directory and archive selections will be sorted
  308.   likewise. The options here are self-explanatory.
  309.  
  310.   * FILE
  311.  
  312.   The function of "File" is to give you the DOS file handling capabilities
  313.   from within the program. The option are self-explanatory.
  314.  
  315.   Also included in this menu is a handy file searching option, which allows
  316.   you to locate any file on the current drive.
  317.  
  318.   WARNING : When using Move from the File menu, the files you select will be
  319.   deleted whether or not they are successfully copied. For example, trying to
  320.   move a file to a directoy with a same named Read-Only file.
  321.  
  322.                                       PAGE 6
  323.  
  324.  
  325.   * FLAG LINE (Second row on screen)
  326.  
  327.   By clicking on the encapsulated letter or pressing the corresponding key,
  328.   you can toggle ON or off the following flags :
  329.  
  330.   [D]irectory  [R]ecursion  [P]assword    [A]uthenticity
  331.  
  332.   Here are some general explanations for these flags. Because each archive
  333.   method has its own idiosyncrasies, you should see the documentation for the
  334.   particular archive method you are using.
  335.  
  336.   Directory use :
  337.   When this flag is activated, files in the archive will be stored with their
  338.   path names and extracted to their stored pathnames. You will be asked to
  339.   enter the base directory when this option is activated. The base directory
  340.   is the directory from which the archive program will be executed.
  341.  
  342.   Recursion use :
  343.   When this flag is activated, you will be prompted to enter the directory
  344.   and filespecs for recursion. Recursion compresses all files given by the
  345.   filespecs in the directory specified and all its subdirectories.
  346.  
  347.   Password use :
  348.   When this flag is activated, you will be prompted to enter passwords when
  349.   it is appropriate. Usually this is when you are compressing, extracting and
  350.   viewing files.
  351.  
  352.   Authenticity use : (see .ZIP manual)
  353.   Currently this flag is only applicable to .ZIP files. When this flag is
  354.   activated it will put authenticity verification on the files you compress.
  355.  
  356.   * " Directory " and " Archive "
  357.  
  358.   Click on " Directory" and " Archive " or press enter with the appropriate
  359.   window activated for the directory and archive selection dialog boxes.
  360.  
  361.   Use the directory selection box to select, make or remove directories.
  362.  
  363.   Use the archive selection box to select or input an archive. Only archives
  364.   for which you have the archive programs for can be selected.
  365.  
  366.   The help lines will guide you through the options in this window.
  367.  
  368.   * <V=View/Edit>
  369.  
  370.   This option is used to view the highlighted file. Options for viewing are
  371.   on the help screen in the view utility. When you invoke the editor EZCODE
  372.   uses the name 'EDIT' by default. To use a name of your choice, use <Alt E>
  373.   and enter the new name. This new name is then saved and used from then on.
  374.  
  375.                                       PAGE 7
  376.  
  377.  
  378.                 GETTING LEGAL
  379.  
  380.   * SHAREWARE STATEMENT
  381.  
  382.   EZ CO*DE is protected by U.S. Copyright law and is not in public domain.
  383.   You are granted a limited license to make an evaluation copy for trial use
  384.   on a private, non commercial basis for the specific purpose of determining
  385.   whether EZ CO*DE is suitable for your purposes.
  386.  
  387.   At the end of the trial period, you should either register or discontinue
  388.   use. Purchase of a disk from a shareware distributor does not constitute
  389.   registration.
  390.  
  391.   Site licenses are available. Please inquire for more information.
  392.   A registration form is on the next page.
  393.  
  394.   * DISCLAIMER OF WARRANTY
  395.  
  396.   IMPORTANT: If you received this program from a bulletin board or a
  397.   shareware distributor, read this warranty information before you register.
  398.   If you do not agree to the terms, please discontinue use.
  399.  
  400.   This program is sold without any express or implied warranties whatsoever,
  401.   including but not limited to merchantability and fitness for a particular
  402.   purpose. In no event shall Charles Hill or Usefull Concepts Co. be liable
  403.   for any damages whatsoever (including, without limitation, damages from
  404.   loss of business profits, business interruption, loss of business
  405.   information, or other pecuniary loss) arising out of the use of or
  406.   inability to use this product, even if Usefull Concepts Co. has been
  407.   advised of the possibility of such damages.
  408.  
  409.   * EZ CO*DE 2.8  AND THE EZ CO*DE MANUAL
  410.  
  411.   Copyright 1993 ∙ Charles Hill ∙ Usefull Concepts ∙ All Rights Reserved
  412.  
  413.   * TRADEMARK USE IN THIS MANUAL
  414.  
  415.   MICROSOFT is a trademark of MICROSOFT CORPORATION
  416.   IBM is a trademark of INTERNATIONAL BUSINESS MACHINES CORPORATION
  417.   PKZIP, PKUNZIP are trademarks of PKWARE INC.
  418.   LHA is a trademark of HARUYASU YOSHIZAKI
  419.   ZOO is a trademark of RAHUL DHESI
  420.   PAK is a trademark of NOGATE CONSULTING
  421.   ARJ is a trademark of ROBERT JUNG
  422.  
  423.   The archive utilities are available from most electronic bulletin boards.
  424.  
  425.                                       PAGE 8
  426.  
  427.  
  428.                  GETTING REGISTERED
  429.  
  430.   To register use the file REGISTER.FRM included in the EZ CO*DE package.
  431.  
  432.   When you register EZ CO*DE, you will receive a letter of confirmation,
  433.   including instructions on how to replace the registration message with your
  434.   name and serial number.
  435.  
  436.   Registration entitles you to the use of the version registered and ALL
  437.   future versions of EZ CO*DE !
  438.  
  439.   Technical support is available for EZ CO*DE through electronic mail at the
  440.   following BBS's :
  441.  
  442.   COMPUSERVE : 70732,343
  443.   PCLINK     : RUNOUT
  444.   GENIE      : C.HILL14
  445.  
  446.   If you wish to attain support through U.S. mail, please include a stamped
  447.   self addressed envelope.
  448.  
  449.   Registered users will be able to get technical support by phone.
  450.  
  451.  
  452.              EZ CO*DE REGISTRATION FORM
  453.                   USEFULL CONCEPTS
  454.                 1303 B CARLISLE DRIVE
  455.               SAN MATEO, CA. 94402-1917
  456.  
  457.              Version you are registering __________
  458.  
  459.  
  460.   NAME _____________________________    QUANTITY REGISTERED    ______________
  461.  
  462.   COMPANY __________________________    AMOUNT AT $30.00 EACH  ______________
  463.  
  464.   ADDRESS __________________________    APPLICABLE SALES TAX   ______________
  465.  
  466.   CITY _____________________________    TOTAL ENCLOSED         ______________
  467.  
  468.   STATE ________ ZIP _______________    CA. RESIDENTS ADD 8% STATE TAX.
  469.  
  470.   DATE ________ PHONE ______________    CHECK IN U.S. FUNDS. THANK YOU.
  471.  
  472.   COMPUSERVE ID ____________   GENIE ID ____________   PCLINK ID ____________
  473.  
  474.   To be displayed in registered copy (check one):  __NAME  __COMPANY
  475.  
  476.        PLEASE BE SURE TO READ THE WARRANTY STATEMENT BEFORE REGISTERING.
  477.  
  478.                                       PAGE 9
  479.  
  480.  
  481.                   VERSION HISTORY
  482.  
  483.   Some updates include undocumented bug fixes.
  484.  
  485.   EZCODE 1.0 - Original release
  486.   EZCODE 1.1 - Fixed bug viewing files in archives on floppies.
  487.            Fixed bug with .ZIP file dates.
  488.            Fixed bug in algorithm for reading .ZIP, .LZH and .ZOO files.
  489.            Fixed bug in memory allocation for >150 directories.
  490.            Fixed bug clearing SFX flag on input archives.
  491.            Put 80x25 color text video mode rather than default mode.
  492.            Made sort selection stay until changed.
  493.            Added line selection in viewing.
  494.   EZCODE 2.0 - Fixed bug in algorithm for reading LHA self extract files.
  495.            Fixed bug initializing printer file handle.
  496.            Fixed bug with Page Down on empty CPF and DIRECTORY windows.
  497.            Fixed bug with root directory highlight-bar in Dir Maint.
  498.            Added mouse support.
  499.   EZCODE 2.1 - Corrected version numbers.
  500.            Restored original videomode on exit.
  501.   EZCODE 2.2 - Fixed a bug where CGA was identified as Hercules.
  502.            Fixed bug restoring color palette on return from DOS.
  503.            Enhanced mouse support.
  504.            Improved efficiency of memory use.
  505.            Added color configuration in viewing.
  506.            Added ability to choose and invoke an editor.
  507.            Added flags to identify authenticity verified files.
  508.   EZCODE 2.3 - Set default edit program to EDIT instead of the incorrect PWB.
  509.            Fixed bug with some error message cosmetics.
  510.            Fixed bug with read-only directories.
  511.            Fixed algorithm for drive configuration.
  512.            Set exits to startup directory.
  513.   EZCODE 2.4 - Fixed algorithm for drive configuration again.
  514.            Removed diskette change line detection.
  515.            Put temporary directory $E in root directory of startup drive.
  516.            Fixed failure to remove $E when returning from editor.
  517.   EZCODE 2.5 - Fixed bug removing tmp file before directory reads.
  518.            Fixed bug restoring screen from DOS with certain video cards.
  519.   EZCODE 2.5 - Fixed bug with eratic cursor on CGA.
  520.            Fixed bug for systems exceeding 512 directories.
  521.            Added feature of retained tags after file operations.
  522.   EZCODE 2.7 - Upgraded for PKZIP 2.0.
  523.            Restructured directory-archive selection and flags.
  524.            Added feature of retained tags after archive operations.
  525.            Improved memory efficieny by 20%.
  526.            Restructured file search routine.
  527.            Added ESC key for exiting viewer.
  528.            Freed PgUp and PgDn keys from affecting cursor in viewing.
  529.            Added EMS usage for data storage.
  530.            Removed fix option.
  531.   EZCODE 2.8 - Fixed bug with tags via mouse.
  532.            Modified directory window, archive window and tags.
  533.            Modified date algorithims for year 2000.
  534.            Removed flags identifying authenticity verified files.
  535.   Special thanks to those people who reported the bugs they found in EZCODE !
  536.  
  537.